home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 3 / Gold Medal Software - Volume 3 (Gold Medal) (1994).iso / os2 / boot2x.arj / BOOTOS2.DOC < prev    next >
Text File  |  1994-04-30  |  21KB  |  444 lines
  1.                       OS/2 V2 BOOT System Create Utility
  2.                       Copyright IBM Corp.  (C) 1992,1994
  3.                             Program Property of IBM
  4.  
  5. The BOOTOS2 program is a utility that allows you to build a BOOTable OS/2 V2.x
  6. system using an existing OS/2 V2.x system.  The BOOT system can be installed on
  7. either Floppy Disks or a Hard Disk Partition.
  8.  
  9. There are three types of BOOT systems you can install:
  10.  
  11.   Minimal : This is a basic OS/2 V2.x system that supports one or more OS/2
  12.             Full Screen sessions.  All 16 and 32-bit OS/2 Full Screen
  13.             applications are supported.  When installed on a hard disk drive,
  14.             you can use the VDM option to add support for full screen VDM
  15.             sessions.  The ability to switch between different Screen Sessions
  16.             is supported by the supplied Protect Shell program, BOS2SHL.  You
  17.             can switch between Screen Sessions, both OS/2 and VDM, using the
  18.             Alt-Esc key sequence.
  19.  
  20.             A Minimal BOOT system can installed on a single 3.5" 1.44M Floppy
  21.             Disk or to a small (2-3M) hard disk partition.  Installation to a
  22.             single 2.88M floppy disk is also supported.  Because of space
  23.             constraints, it is highly recommended that unless you are
  24.             installing to a 2.88M disk or to a hard disk partition, you use
  25.             the 2DISK option to create a 2-Disk BOOT System.  If your A: drive
  26.             is 5.25" 1.2M, the 2DISK option will be assumed.
  27.  
  28.        PM : This is an OS/2 V2.x system that supports one or more OS/2 Full
  29.             Screen or PM sessions.  If the VDM option is specified, support for
  30.             both Windowed (i.e. Seemless) and Full Screen VDM sessions is
  31.             added.  The ability to switch between different Screen Sessions is
  32.             supported by the supplied Protect Shell program, PMSHELL. You can
  33.             switch between Screen Sessions, both OS/2 and VDM, using the
  34.             Alt-Esc key sequence.
  35.  
  36.             A PM BOOT System requires about 9M of hard disk space.  This does
  37.             not include the disk space needed for the SWAP file.
  38.  
  39.       WPS : This is an OS/2 V2.x system that supports one or more OS/2 Full
  40.             Screen or PM sessions.  If the VDM option is specified, support for
  41.             both Windowed (i.e. Seemless) and Full Screen VDM sessions is
  42.             added.  The ability to switch between different Screen Sessions is
  43.             supported by the supplied Protect Shell program, PMSHELL. You can
  44.             switch between Screen Sessions, both OS/2 and VDM, using the
  45.             Alt-Esc key sequence.  The difference between this and a PM BOOT
  46.             System is the availability of the OS/2 WPS.  Certain default System
  47.             Program and Folder objects are included.
  48.  
  49.             A WPS BOOT System requires about 9M of hard disk space.  This does
  50.             not include the disk space needed for the SWAP file.
  51.  
  52.     Syntax:  BOOTOS2   <SOURCE=drive:\path\>
  53.                        <TARGET=drive>
  54.                        <TYPE=PM|WPS>
  55.                        <NLS(Country,KBD,CodePage)>
  56.                        <2DISK[=drive]>
  57.                        <ABIOS>
  58.                        <REXX>
  59.                        <SWAP=drive:\path\>
  60.                        <TRACE[=drive:\path\file]>
  61.                        <HELP>
  62.                        <SYSED>
  63.                        <VDM>
  64.                        <FORMAT[:FAT]>
  65.                        <FORMAT:HPFS>
  66.                        <FORMAT:NONE>
  67.                        <QUIET>
  68.                        <GA200|SP200|GA210|SP211|MR211>
  69.  
  70.              SOURCE=  Depending on what type of install you ask BOOTOS2 to
  71.                       perform, certain files might be required from the
  72.                       install disks you used to create your active OS/2
  73.                       system.  One file that is always required is SYSINSTX
  74.                       which is used to create the OS/2 BOOT record, OS2BOOT.
  75.                       The file SYSINSTX.COM is (so far) always found on the
  76.                       first Install disk.  If you are creating a BOOT Disk,
  77.                       then the files KEYBOARD.DCP, VTBL850.DCP, and the
  78.                       CONFIG.SYS file from the install disk are also required.
  79.                       These files (so far) are always found on the second
  80.                       install disk.
  81.  
  82.                       Normally BOOTOS2 will prompt you for the Install disks
  83.                       it needs.  However, if you installed OS/2 over a LAN
  84.                       or equivalent redirected source, you can use the SOURCE
  85.                       option to point to these redirected sources.  The value 
  86.                       of SOURCE is usually a standard CID directory structure,
  87.                       as defined in "GG24-3780 : OS/2 V2.0 and V2.1 Remote 
  88.                       Installation and Maintenance".
  89.  
  90.                       Alternatively, SOURCE can point to a single directory
  91.                       where all the required files are located.  This is the
  92.                       usual format OS/2 CSD remote installs where all the 
  93.                       install disks are copied to a single directory.  You
  94.                       could alternatively create a single directory that
  95.                       contains only those files needed by BOOTOS2 and use the
  96.                       SOURCe option so users won't have to worry about install
  97.                       disks.
  98.  
  99.              TARGET=  By default, BOOTOS2 will install the BOOT system on a
  100.                       floppy disk in your A: drive.  You can use the TARGET=
  101.                       argument to specify an alternate Drive to install the
  102.                       BOOT system on.  This alternate drive can be another
  103.                       floppy or a Hard Disk Drive.  Any medium capable of
  104.                       being booted from can be a target.
  105.  
  106.                       Values for target are a single drive letter: A .. Z
  107.  
  108.              TYPE=PM  BOOTOS2 will install a BOOT System that will support
  109.                       PM Applications.  The BOOT System will be accessed as
  110.                       a single OS/2 Windowed Command Prompt.
  111.  
  112.             TYPE=WPS  BOOTOS2 will install a BOOT system that will support
  113.                       PM Applications.  The BOOT System will be accessed
  114.                       using the OS/2 WorkPlace Shell (WPS).
  115.  
  116.                  NLS  By Default, BOOTOS2 will get information regarding the
  117.                       NLS environment from the following CONFIG.SYS statements:
  118.  
  119.                       DEVINFO=KBD,xx,KEYBOARD.DCP     : Default xx  = US
  120.                       COUNTRY=xxx,COUNTRY.SYS         : Default xxx = 001
  121.                       CodePage=xxx                    : Default xxx = 850
  122.  
  123.                       If your environment requires different values for the
  124.                       above statements, you specify them via the NLS argument.
  125.                       Please note that you must specify all three values.
  126.  
  127.                       NOTE: The statement is only valid for a TYPE=PM or
  128.                             TYPE=WPS install.  For a minimal install (the
  129.                             default) the 'stripped' versions of the NLS
  130.                             modules, KEYBOARD.DCP and VTBL850.DCP, are
  131.                             used which do not support alternate values.
  132.  
  133.                2DISK  If creating a BOOT system where the target is a floppy
  134.                       disk drive, the 2DISK option allows you to spread the
  135.                       BOOT system across two disks, increasing the amount of
  136.                       space available for both required and optional files.
  137.  
  138.                       By default, if your system has a B: drive, BOOTOS2 will
  139.                       use that as the second drive.  If you don't have a B:
  140.                       drive then BOOTOS2 will use A: for both disks (in which
  141.                       case you'll have to swap disks during OS/2 IPL).
  142.  
  143.                       Alternatively, you can specify an alternative target
  144.                       drive for the second drive.  This is useful when you
  145.                       want to use a floppy drive other than B (for whatever
  146.                       reason).
  147.  
  148.                       Also, if you have a B: drive, but still want to create a
  149.                       2-Disk BOOT system using only the A: drive, you can 
  150.                       specify 2DISK=A to override the default of using B.
  151.  
  152.                 REXX  If room allows, support for REXX will be installed.
  153.  
  154.                 HELP  BOOTOS2 will try and add basic OS/2 Help support.
  155.  
  156.                  VDM  Support for Virtual Dos Machines (VDMs) will added.
  157.  
  158.                       *NOTE* This option can not be used when the target
  159.                              drive is a floppy disk.
  160.  
  161.                       *NOTE* When VDM support is installed on a Minimal
  162.                              system (Text Only), to start a new VDM session
  163.                              press the Ctrl-D key combination.  This will
  164.                              invoke a new VDM session.
  165.  
  166.                SYSED  Add support for the OS/2 System Editor (E.EXE)
  167.  
  168.                SWAP=  For a TYPE=PM or TYPE=WPS install, the default value for
  169.                       the SWAPPATH is the ROOT directory of the target BOOT
  170.                       system.  You can use this option to place teh Swap File in
  171.                       a different directory.
  172.  
  173.                TRACE  Use this option to create a Trace of the Install Process.
  174.                       A file called BOOTOS2.LOG will be created that will
  175.                       contain a complete record of the requested BOOT System
  176.                       Install process.  By default the LOG file will be created
  177.                       on the same physical directory the BOOTOS2.EXE program
  178.                       resides on.  You can optionally specify an alternate path
  179.                       for the LOG file; e.g. TRACE=drive:\path
  180.  
  181.               FORMAT  You can use this option to have BOOTOS2 force a certain
  182.                       type of Format (i.e. FAT, HPFS, or NONE) to the target
  183.                       drive.  This is usefull for automated processes.
  184.  
  185.                QUIET  This will run BOOTOS2 such that no output is produced.
  186.                       This is also useful for automated processes.  You can
  187.                       use the TRACE option to maintain a record of the install.
  188.                       Please note that because BOOTOS2 can't prompt the user
  189.                       to ask about formating the target drive, if you don't
  190.                       explicitly specify the FORMAT option, FOAMRT:FAT will
  191.                       be assumed.
  192.  
  193.                The following 5 options can be used to force BOOTOS2 to assume
  194.                that the specified OS/2 v2.x version is the 'active' level.
  195.                Usually BOOTOS2 will determine this automatically by examining
  196.                the SYSLEVEL.OS2 file, so you shouldn't need to use these
  197.                options under normal circumstances.  However, there are times
  198.                when the SYSLEVEL.OS2 file can become corrupted, making it
  199.                impossible for BOOTOS2 to determine the active system level.
  200.                You can use these options to get around this problem.
  201.  
  202.                GA200  OS/2 2.00 GA
  203.                SP200  OS/2 2.00 SP
  204.                GA210  OS/2 2.10 GA
  205.                SP211  OS/2 2.11 CSD SP
  206.                MR211  OS/2 2.11 Manufacturers Refresh
  207.  
  208. You must run BOOTOS2 from an existing OS/2 V2 system.  The BOOTOS2 program
  209. will analyze your system and create a BOOT system that is specific for it.  For
  210. example it will determine if your system supports features such as HPFS or SCSI
  211. and add the appropriate support for it.  Because of this, a BOOT disk created
  212. for a specific workstation will not necessarily work correctly on a different
  213. workstation.
  214.  
  215. If you install the BOOT system on a Hard Disk Drive, you'll probably want to
  216. also install the OS/2 BOOT Manager and add the BOOT system to it.
  217.  
  218. Please note that the BOOT system installed with this release of BOOTOS2 does
  219. not support Windows.  A future release of the program might do so
  220. if enough users want it (and I figure out how).
  221.  
  222. The file BOOT2X.ZIP contains the following files:
  223.  
  224.   BOOTOS2.EXE       * The OS/2 BOOT System Create Utilty for OS/2 V2.0
  225.   BOOTOS2.ABS       * Short Abstract descriping the Function of SE20BOOT
  226.   BOOTOS2.DOC       * Documentation for SE20BOOT
  227.   BOS2U20.INI       * User   INI file needed for OS/2 2.0
  228.   BOS2S20.INI       * System INI file needed for OS/2 2.0
  229.   BOS2U21.INI       * User   INI file needed for OS/2 2.0+SP and OS/2 2.1
  230.   BOS2S21.INI       * System INI file needed for OS/2 2.0+SP and OS/2 2.1
  231.   BOS2REXX.EXE      * Stub Module for REXX Support
  232.   BOS2SHL.EXE       * Protect Shell program for use instead of SYSINST1
  233.   LICENSE.TXT       * IBM License Agreement
  234.  
  235. Author:
  236.  
  237. Kennneth A. Kahn,  IBM Poughkeepsie N.Y.
  238.  
  239. CompuServe - 71333,2526
  240. Internet   - KENKAHN@VNET.IBM.COM
  241. IBM Mail   - USIB25P9 at IBMMAIL
  242.  
  243.  
  244. History:
  245.  
  246. 08/92 : (v1.00)
  247.  
  248. - Initial release
  249.  
  250. 03/93 : (V2.00)
  251.  
  252. - Fixed a problem where BOOTOS2 was not recognizing a Floppy Disk Drive as a
  253.   Removable medium if no Disk was in it when the program first started.  This
  254.   would cause BOOTOS2 to install the wrong BOOT System, resulting in various
  255.   errors.
  256.  
  257. - Fixed problem with FORMAT by making it run Synchronously so if it Fails, an
  258.   error code will be returned.
  259.  
  260. - Added support for NLS Statement
  261.  
  262. - When COPYing file, added more meaningful error messages
  263.  
  264. - Fixed problem running BOOTOS2 from a ROOT Directory
  265.  
  266. - The temporary directory where files from the install disks are copied is
  267.   changed from the directory where BOOTOS2.EXE is executed from to a new
  268.   subdirectory based off of it named BOS2TEMP  This will prevent BOOTOS2 from
  269.   overwriting and deleting system files when it is located on the \OS2
  270.   directory of the BOOT Drive.
  271.  
  272. - The INI files can now be located on your DPATH
  273.  
  274. - If the Target Drive is already formatted and contains data, the option to
  275.   run the Install without formating is given.
  276.  
  277. - Added special support for the Image Adapter/A
  278.  
  279. - All DLLs will be located via LIBPATH instead of looking automatically for it
  280.   in \OS2\DLL
  281.  
  282. - Changed TARGET= to allow for X or X:
  283.  
  284. - For a minimal install, a check will be made to see if there is enough room
  285.   left on the target drive to copy over extra files like CHKDSK, UHPFS and
  286.   OSO001.MSG
  287.  
  288. - Fixed problem where HPFS support was not added if the Target drive was
  289.   formatted for HPFS but the active system did not have HPFS support.
  290.  
  291. - Added support for 2-Disk BOOT System via 2DISK argument
  292.  
  293. - Added NLS support for FORMAT by querying system for the response character
  294.   to use: US default is 'Y'
  295.  
  296. - Added support for a BOOT system when active system is OS/2 2.0 with Service
  297.   Pack or OS/2 2.1
  298.  
  299. - Added support for REXX invocation argument
  300.  
  301. - Added support for ABIOS argument.  This allows a user to explicitly specify
  302.   that the workstation supports ABIOS.  This will allow the user to circumvent
  303.   the  problem where "RAM Loadable" MicroChannel machines were being diagnosed
  304.   as not supporting ABIOS; causing the wrong set of system files to be loaded.
  305.  
  306. - Changed external name to BOOTOS2
  307.  
  308. - Added support for the TRACE invocation option
  309.  
  310. - Added support for the SWAP= invocation argument
  311.  
  312. 05/93 : (V3.00)
  313.  
  314. - Updated BOS2U21 and BOS2S21 files to 2.1 GA levels
  315.  
  316. - Fixed 2DISK option.  It will no longer return RC=4 after trying
  317.   to format B.
  318.  
  319. - Added support for SVGA; Copy over \OS2\SVGADATA.PMI
  320.  
  321. - Added code to copy over BASEDEV= invocation arguments
  322.  
  323. - Added code to copy over HELPMGR.DLL if room allows
  324.  
  325. - Added 2.1 support for 8514 by updating BOS2U21.INI with the proper values
  326.   for PM_DISPLAYS.  This updating of BOS2U21 will be done for all display
  327.   types if necessary.
  328.  
  329. - Added support for HPFS386
  330.  
  331. - For a Disk Install, install sequence changed so the files SYSINST1 and
  332.   HARDERR are only copied if there is room.  This frees up room for BIO
  333.   files required by certain MicroChannel machines that could not fit
  334.   otherwise.
  335.  
  336.   *NOTE* If SYSINST1/HARDERR are not installed, then CAD will not work
  337.  
  338. - Enhanced install of BASEDEV drivers.  For a single 1.44M BOOT Disk, only
  339.   those BASEDEV drivers that are needed for accessing DASD (.ADD) are copied.
  340.   Otherwise, if room allows, all BASEDEV drivers will be copied.
  341.  
  342. - Removed copying of DTM.DLL for a TYPE=PM or TYPE=WPS install.  It wasn't
  343.   needed for anything as far as I could tell and at least one user complained
  344.   it wasn't installed on his base OS/2 system
  345.  
  346. - Support for the IBM IA/A is not working in this release.  I am trying to get
  347.   help with this from the IA/A development team, but it might take a while.  If
  348.   you have IA/A support installed on your active system when you run BOOTOS2,
  349.   you can try the following:
  350.  
  351.   * On the \OS2\DLL directory of your active OS/2 2.x system, look for a file
  352.     named DISPLAY.OLD; this is the DISPLAY.DLL that was active before you ran
  353.     the IA/A INSTALL program.  Copy this 'over' the DISPLAY.DLL that BOOTOS2
  354.     installed on the \OS2\DLL directory of your 'target' system.
  355.  
  356.   * In the CONFIG.SYS of your target system, look for the following statements:
  357.  
  358.     DEVICE=\OS2\XGARING0.SYS
  359.     DEVICE=\OS2\IAOS2RFS.SYS
  360.     SET VIDEO_DEVICES=VIO_yyy,VIO_IBMIAA
  361.     SET VIO_IBMIAA=DEVICE(BVHVGA,BVHIAA)
  362.     SET VIO_yyy=DEVICE(BVHVGA,BVHyyy)
  363.  
  364.   * Change these to:
  365.  
  366.     rem DEVICE=\OS2\XGARING0.SYS
  367.     rem DEVICE=\OS2\IAOS2RFS.SYS
  368.     SET VIDEO_DEVICES=VIO_yyy
  369.     rem SET VIO_IBMIAA=DEVICE(BVHVGA,BVHIAA)
  370.     SET VIO_yyy=DEVICE(BVHyyy)
  371.  
  372.   * Do this *BEFORE* you IPL your Target BOOTOS2 System
  373.  
  374. 03/94 : (V4.00)
  375.  
  376. - Enhanced the 2DISK option to work on a system with a single Disk Drive.
  377.  
  378. - Enhanced the TRACE option to accept an alternate PATH where BOOTOS2.LOG will
  379.   be created.
  380.  
  381. - For XGA support, all files on the XGA$DMQS directory will now be copied to
  382.   the Target Drive.
  383.  
  384. - Enhanced BASEDEV processing to search for target files via DPATH instead of
  385.   just on the \OS2 directory.
  386.  
  387. - Fixed support HPFS386 support; files HPFS200.386 and HFS.MSG are copied as
  388.   well as HPFS386.IFS.  For a minimal install, the BOOTSH.EXE OS/2 Shell program
  389.   will be copied and used as the PROTSHELL.
  390.  
  391. - For SVGA support, made copying of SVGADATA.PMI optional.  This is in case the
  392.   SVGA ON command was not yet run
  393.  
  394. - Mouse support will be added to a minimal BOOT System if room allows
  395.  
  396. - Added support for the OS/2 2.11 CSD SP and 2.11 Manfacturers Refresh
  397.  
  398. - Enhanced SOURCE= to allow for Service Pack (CSD) install by allowing it to
  399.   point to a single directory instead of a CID directory structure.
  400.  
  401. - Added HELP option to optionally add support for OS/2 Help 
  402.   if room allows.  The files HPMGRMRI.DLL and HMHELP.HLP are
  403.   are copied, and a SET HELP= statement is added to the     
  404.   CONFIG.SYS                                                
  405.  
  406. - For a minimal system, BOOTOS2 will now use it's own SHELL program, BOOTSHL,
  407.   instead of SYSINST1.  Unlike SYSINST1, BOOTSHL program supports multiple
  408.   screen sessions (via Alt-Esc).  It also supports STARTUP.CMD
  409.  
  410. - Added support for VDMs via VDM option
  411.  
  412. - Added some new invocation arguments to allow for
  413.   unattended installs.
  414.  
  415.   FORMAT[:FAT]  = Automatically Format Target for FAT
  416.   FORMAT:HPFS   = Automatically Format Target for HPFS
  417.   FORMAT:NONE   = Automatically Skip the Target Format
  418.  
  419. - Added SYSED option to optionally add support for the
  420.   OS/2 System Editor (E.EXE)
  421.  
  422. - Added SYSINSTX as an optional install file            
  423.  
  424. - Added optional target to 2DISK option (2DISK=x:)      
  425.  
  426. - Added code to cleanup, and remove, BOS2TEMP when done 
  427.  
  428. - Added QUIET argument to allow suppression of all output
  429.   to StdOUT                                              
  430.  
  431. - Verified all cases where BOOTOS2 ends in error would   
  432.   return a non-zero code                                 
  433.                                                          
  434. - Added Stacker Support.                                 
  435.  
  436. - Removed COM.SYS as file that BOOTOS2 will install for 
  437.   serial mouse support (not needed)                     
  438.  
  439. - Updated SOURCE option to look for either CID directory
  440.   structure or a single directory                       
  441.  
  442. - Added support for AOX upgrade.  If OEMXLAT.SYS is found
  443.   on active system, it will copied to target drive       
  444.